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APPENDIX 



An exemplary interface definition illustrating code that defines an API according to an 
embodiment of the present invention is presented below. As noted above, it will be appreciated 
that any such definition is equally compatible with an embodiment of the present invention, and 
therefore the present invention is not limited to the language, text, format, and the like, of the 
below-listed exemplary interface definition. The comments included in the definition are for 
illustrative purposes only, and are not a comprehensive listing of the functions that may be 
performed by an embodiment of the present invention. 



// Type definitions 
typedef DWORD PID; 
typedef DWORD SDI_SPID; 
typedef DWORD BID; 
typedef DWORD WID; 
typedef DWORD IDX; 
typedef DWORD OFF; 
typedef DWORD PRID; 
typedef DWORD DBGDBID; 
typedef UINT64 TASKID; 
typedef DWORD NLVL; 

//Forward declarations of interfaces 
interface IHostDebugDebuggerlnstance; 
interface IHostDebugServerlnstance; 
interface IHostDebugEvent; 
interface IHostDebug; 

//Interface definitions 
[ 

Uuid(87bcl8db-c8b3-lld5-ae96-00b0d0e93ccl), 
pointer_default(unique) 

] 

interface IHostDebugDebuggerlnstance : IUnknown 
{ 

HRESULT OnMatch( 

[in, string] const wchar_t * szClientMachine, 

[in] PID pidClient, 

[in] IHostDebug * pDebug, 

[out] IHostDebugEvent ** ppDebugEvent); 

} 
t 

Uuid(87bcl8dc-c8b3-lld5-ae96-00b0d0e93ccl), 
pointer_default(unique) 

] 

interface IHostDebugServerlnstance : IUnknown 

{ 

HRESULT Register( 

[in, string] const wchar_t * szClientMachine, 
[in] PID pidClient, 

[in] IHostDebugDebuggerlnstance * plnstance, 

[in] BOOL fReservedMustBeFalse, // DebugExistingConnections 

[out] DWORD * pdwCookie, 
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[out] DWORD * pdwPidServer); 
HRESULT Unregister( 
[in] DWORD dwCookie); 

} 

typedef struct HOST_DEBUG_SPAN 

{ 

EDX midxStart; 
OFF moffStart; 
OFF moffEnd; 
} HOSTDEBUGSPAN; 

typedef struct HOST_DEBUG_STATEMENT 

{ 

HOSTJDEBUGSPAN m_span; 
BOOL m bDynamic; 
[switch_is(m_bDynamic)] union 

{ 

[case(TRUE)] struct 
{ 

BID m_J>id; 
WID m wid; 
NLVL mnlvl; 

}; 

[case(FALSE)] struct 
{ 

PRID m_prid; 

[string] wchar_t * m szDbName; 
DBGDBID m_dbid; 

}; 

}; 

} HOST_DEBUG_STATEMENT; 

typedef enum HOST_DEBUG_STEPKIND 

{ 

HOSTDEBUGSTEPKINDSTEPCOMPLETE = 1, 
HOSTDEBUGSTEPKINDBREAKPOINTHIT = 2, 
HOST DEBUG STEPKIND ASYNC BREAK = 8 
} HOST DEBUG STEPKIND; 

// This interface is implemented by the debugger and called by SQL SER VER 
[ 

uuid(87bc 1 8dd-c8b3- 1 1 d5-ae96-00b0d0e93 cc 1 ), 
pointerdefault(unique) 

] 

interface IHostDebugEvent : IUnknown 

{ 

// Called on new connection to the database 
HRESULT NewConnection( 

[in] SDI^SPED spidParent, 

[in] BID bidParent, 

[in] WID widParent, 

[in] SDI_SPID spid, 

[in, string] const wchar t * szSqlServer, 

[in, string] const wchar_t * szMachine, 

[in, string] const wchar_t * szClientMachine, 

[in, string] const wchar t * szClientProcessName, 

[in, string] const wcharj * szClientUserName, 

[in] PID pid, 

[in] DWORD dwThreadld); 
// Called when a new batch is started (MARS). 
// There is an implicit worker 
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// (WID==0) that is assumed with this operation 
// (ie. NewWorker is not 

//called unless a UDF actually gets parallelized). 
HRESULT NewBatch( 

[in] BID bid); 
// Called for each helper that is created during 
//parallel execution of a UDF 
HRESULT NewWorker( 

[in] BID bid, 

[in] WID wid, 

[in] NLVL nlvl); 
// Called when a stored procedure is executed. 
HRESULT Push( 

[in] BID bid, 

[in] WID wid, 

[in, string] const wchar_t * szDBName, 
[in, string] const wchar_t * szObjectName, 
[in] DBGDBID dbid, 
[in] PRID prid, 
[in] NLVL nlvl, 
[in] UINTPTR esp, 
[in] ULONG ulThreadld, 
[in] USHORT usValidSpans, 

[in, size_is(usValidSpans)] HOST_DEBUG_SPAN * arDebugSpan); 
HRESULT PushDynamic( 
[in] BID bid, 
[in] WID wid, 
[in] NLVL nlvl, 
[in] UINT PTR esp, 
[in] ULONG ulThreadld, 
[in, string] wchar_t * szText, 
[in] USHORT usValidSpans, 

[in, size_is(usValidSpans)] HOSTDEBUGSPAN * arDebugSpan); 
HRESULT Step( 
[in] BID bid, 
[in] WID wid, 
[in] PRID prid, 
[in] NLVL nlvl, 

[in] HOST_DEBUG_STEPKIND stepkind, 

[in] HOST_DEBUG_SPAN span, 

[in] ULONG ulThreadld); 
//Balances out calls to NewSP 
HRESULT Pop( 

[in] BID bid, 

[in] WID wid, 

[in] NLVL nlvl); 
HRESULT CloseConnection([in] SDI_SPID spid); 
HRESULT CloseBatch( 

[in] BID bid); 
HRESULT CloseWorker( 

[in] BID bid, 

[in] WID wid); 
HRESULT Trace( 

[in] BID bid, 

[in] WID wid, 

[in, string] const wchart * szOutput); 
HRESULT CallManagedFromTsql( 

[in] BID bid, 

[in] WID wid, 

[in] TASKID taskid); 
HRESULT ReturnToTsqlFromManaged( 

[in] BID bid, 
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[in] WID wid, 

[in] TASKID taskid); 
HRESULT CallTsqIFromManaged( 

[in] BID bid, 

[in] WID wid, 

[in] TASKID taskid); 
HRESULT ReturnToM anagedFromTsql( 

[in] BID bid, 

[in] WID wid, 

[in] TASKID taskid); 
HRESULT Ping(); 



interface IEnumHostDebugSymbol; 



uuid(87bc 1 8df-c8b3- 1 Id5-ae96-00b0d0e93ccl ), 
pointerjiefault(unique) 

] 

interface IHostDebugBinary : IUnknown 

{ 

HRESULT Get( 

ULARGEINTEGER ulOffset, 

ULONG cbToRead, 

[out, size_is(cbToRead), 

length_is(*pcbActuallyRead)] char * arcBuf, 

[out] ULONG * pcbActuallyRead); 
HRESULT Set( 

[in] ULONG cbWrite, 

[in, size_is(cb Write)] char * arcBuf); 
HRESULT GetSize( 

[out] DWORD * pdwSize); 



typedef enum HOST_DEBUG_SYMBOL_TYPE 

{ 

HOST DEBUG SYMBOL TYPE LEAF, 
HOSTDEBUGSYMBOLTYPECOMPOUND, 
HOST DEBUG SYMBOL TYPE BINARY 
} HOST DEBUG SYMBOL TYPE; 

typedef enum HOSTJDEBUG_SYMBOL_PROPERTIES 

{ 

HOST_DEBUG_SYMBOL_PROPERTIES_GLOBAL = 1, 
HOST_DEBUG_SYMBOL_PROPERTIES_LOCAL - 2, 
HOSTDEBUGSYMBOLPROPERTIESPARAM = 4, 
HOST_DEBUG_SYMBOL_PROPERTIES_VAR_NAl =8, 
HOST_DEBUG_SYMBOL_PROPERTIES_VAR_NA2 = 16, 
HOST_DEBUG_SYMBOL_PROPERTIES_READONLY = 32, 
HOST_DEBUG_SYMBOL PROPERTIES JSTULL = 64, 
HOST_DEBUG_SYMBOL_PROPERTIES_XML = 128, 

HOST_DEBUG_SYMBOL_PROPERTIES_TEXT = 256 
} HOST DEBUG S YMBOL PROPERTIES ; 

//Represents a variable in SQL SERVER. 
//Allows simple types, array, and heirarchy 
typedef struct HOST_DEBUG_SYMBOL 
{ 

[string] wchart * m szName; 
[string] wchar t * mszType; 
ULONG m_ulProperties; 

HOSTDEBUGSYMBOLTYPE m_symbolType; 
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[switch_is(m_symbolType)] union 

{ 

[case(HOST_DEBUG_SYMBOL_TYPE_LEAF)] struct 
{ 

[string] wchart * m szValue; 

}; 

[case(HOST_DEBUG_SYMBOL_TYPE_COMPOUND)] struct 

{ 

IEnumHostDebugSymbol * m_pEnum; 

}; 

[case(HOST_DEBUG_SYMBOL_TYPE_BINARY)] struct 

{ 

IHostDebugBinary * m_pBinary; 

}; 

}; 

} HOST_DEBUG_SYMBOL; 



uuid(87bc 1 8e0-c8b3- 1 1 d5-ae96-00b0d0e93cc 1 ), 
pointerdefault(unique) 

] 

interface IEnumHostDebugSymbol : IUnknown 

{ 

HRESULT Next( 

[in] ULONG ulSymbolsToFetch, 

[out, size_is(ulSymbolsToFetch), length_is(*pulSymbolsFetched)] 
HOSTDEBUGSYMBOL * arSymbols, 

[out] ULONG * pulSymbolsFetched); 
HRESULT Skip( 

[in] ULONG ulSymbolsToSkip); 
HRESULT ResetQ; 
HRESULT Clone( 

IEnumHostDebugSymbol ** ppEnum); 
HRESULT GetCount( 

[out] DWORD * pdwCount); 



typedef enum HOST_DEBUG_STEP_MODE 

{ 

HOST_DEBUG_STEP_INTO, 
HOST_DEBUG_STEP_OVER, 
HOSTDEBUGSTEPTORETURN, 
HOST_DEBUG_STEP_GO 
} HOST DEBUG STEP MODE; 



uuid(87bc 1 8de-c8b3- 1 1 d5-ae96-00b0d0e93cc 1), 
pointerdefault(unique) 

] 

interface IHostDebug : IUnknown 

{ 

HRESULT Continue( 
[in] BID bid, 
[in] WID wid, 

[in] HOST DEBUG STEP MODE step); 
HRESULT StopDebugEvents(); 
HRESULT SetBreakpoints( 

[in] BOOL fEnable, 

[in] long nBreakpoints, 

[in, size_is(nBreakpoints)] HOST DEBUG STATEMENT * arBreakpoints); 
HRESULT GetCallstack( 
[in] BID bid, 
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[in] WID wid, 

[out] long * pnStatements, 

[out, size_is(, *pnStatements)] HOST_DEBUG_STATEMENT ** parStatements); 
HRESULT AsyncBreak( 

[in] BID bid, 

[in] WID wid); 
HRESULT RevokeBreak( 

[in] BID bid, 

[in] WID wid); 
HRESULT SetSym( 

[in] BID bid, 

[in] WID wid, 

[in] NLVL nlvl, 

[in] HOST_DEBUG_SYMBOL * pSymbol); 
HRESULT GetSyms( 
[in] BID bid, 
[in] WID wid, 
[in] NLVL nlvl, 
[out] USHORT * pusSymbols, 

[out, size_is(,*pusSymbols)] HOSTDEBUGSYMBOL ** ppSymbols); 
HRESULT GetGlobalSym( 
[in] BID bid, 
[in] WID wid, 

[in, string] wchart * szVariable, 
[out] HOST DEBUG SYMBOL * pSymbol); 
HRESULT LookupTaskIdentifier( 
[in] BID bid, 
[in] WID wid, 
[out] TASKID * pTaskid); 
//Ifthe debugger gets hosed, 
// allow the server to continue untouched 
HRESULT StopDebuggingQ; 
HRESULT CreateManagedDebuggerHost( 
[in] wchar t * szVersion, 

// version string passed from debugger 
[in] wchar t * szArg); 

// argument string passed from debugger 
// This is disabled by default 
HRESULT ToggleManaged( 
[in] BOOL fEnableManaged); 
HRESULT Ping(); 

} 



